home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / apanel.z / apanel
Text File  |  1998-10-30  |  73KB  |  1,057 lines
  1.  
  2.  
  3.  
  4. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _a_u_d_i_o_p_a_n_e_l - control panel for Audio Hardware: input and output levels,
  10.      rates, sources and syncs
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      aaaauuuuddddiiiiooooppppaaaannnneeeellll [ ----nnnnooooddddiiiissssppppllllaaaayyyy ] [ ----nnnnooooffffoooorrrrkkkk ] [ ----pppprrrriiiinnnntttt ]
  14.                 [ ----ddddeeeeffffaaaauuuullllttttiiiinnnn _d_e_v_i_c_e_n_a_m_e ]  [ ----ddddeeeeffffaaaauuuullllttttoooouuuutttt _d_e_v_i_c_e_n_a_m_e ]
  15.                 [ ----ooooppppeeeennnnffffiiiilllleeee _f_i_l_e_n_a_m_e ]     [ ----ssssaaaavvvveeeeffffiiiilllleeee _f_i_l_e_n_a_m_e ]
  16.                 [ ----ddddeeeevvvviiiicccceeeelllliiiisssstttt{oooonnnn,ooooffffffff}]     [ ----ssssccccrrrroooollllllllbbbbaaaarrrr{oooonnnn,ooooffffffff}]
  17.                 [ ----qqqquuuuiiiicccckkkkhhhheeeellllpppp{oooonnnn,ooooffffffff}]      [ ----pppprrrroooommmmooooddddeeee{oooonnnn,ooooffffffff}]
  18.                 [ ----ppppoooolllllllliiiinnnntttteeeerrrrvvvvaaaallll _t_i_m_e ]     [ ----iiiiccccoooonnnniiiicccc ]
  19.                 [ ----sssshhhhoooowwwwddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e [, _d_e_v_i_c_e_n_a_m_e_2, ... ] ]
  20.                 [ ----hhhhiiiiddddeeeeddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e [, _d_e_v_i_c_e_n_a_m_e_2, ... ] ]
  21.                 [ ----pppprrrreeeesssseeeennnntttteeeerrrrmmmmuuuutttteeee{oooonnnn,ooooffffffff}]  [ ----pppprrrreeeesssseeeennnntttteeeerrrrttttoooonnnneeee _t_o_n_e ]
  22.                 [ ----pppprrrreeeesssseeeennnntttteeeerrrrlllleeeevvvveeeellllssss _l_e_v_e_l ]
  23.  
  24.                 [ ----ddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e ]     [ ----iiiinnnntttteeeerrrrffffaaaacccceeee _i_n_t_e_r_f_a_c_e_n_a_m_e ]
  25.  
  26.                 [ ----sssshhhhoooowwww ] [ ----hhhhiiiiddddeeee ]        [ ----ddddbbbbssssccccaaaalllleeee ] [ ----ddddeeeeccccaaaaddddeeeessssccccaaaalllleeee ]
  27.                 [ ----rrrraaaatttteeee _r_a_t_e ]             [ ----ssssyyyynnnnccccssssoooouuuurrrrcccceeee _s_y_n_c_n_a_m_e ]
  28.                 [ ----[uuuunnnn]ggggrrrroooouuuuppppsssslllliiiiddddeeeerrrrssss ]      [ ----ssssoooouuuurrrrcccceeee _i_n_t_e_r_f_a_c_e_n_a_m_e ]
  29.  
  30.                 [ ----mmmmoooonnnniiiittttoooorrrr{oooonnnn,ooooffffffff}]        [ ----mmmmeeeetttteeeerrrr{oooonnnn,ooooffffffff}]
  31.                 [ ----[uuuunnnn]ggggaaaannnnggggiiiinnnnppppuuuutttt ]         [ ----mmmmiiiiccccmmmmooooddddeeee _m_o_d_e ]
  32.                 [ ----iiiinnnnrrrraaaatttteeee _r_a_t_e ]
  33.  
  34.                 [ ----[uuuunnnn]ggggaaaannnnggggoooouuuuttttppppuuuutttt ]        [ ----oooouuuuttttrrrraaaatttteeee _r_a_t_e ]
  35.                 [ ----[uuuunnnn]mmmmuuuutttteeee ]              [ ----pppprrrroooossssuuuubbbbccccooooddddeeee{oooonnnn,ooooffffffff}]
  36.  
  37.                 [ ----ggggaaaaiiiinnnn _d_B_l_e_v_e_l [ _d_B_l_e_v_e_l ... ] ]
  38.                 [ ----cccchhhhaaaannnnnnnneeeellllssss _n_u_m_c_h_a_n_n_e_l_s ]
  39.  
  40.                 [ ----iiiinnnnlllleeeevvvveeeellllssss _l_e_v_e_l ]
  41.                 [ ----iiiinnnnlllleeeevvvveeeelllllllleeeefffftttt1111 _l_e_v_e_l ]    [ ----iiiinnnnlllleeeevvvveeeellllrrrriiiigggghhhhtttt1111 _l_e_v_e_l ]
  42.                 [ ----iiiinnnnlllleeeevvvveeeelllllllleeeefffftttt2222 _l_e_v_e_l ]    [ ----iiiinnnnlllleeeevvvveeeellllrrrriiiigggghhhhtttt2222 _l_e_v_e_l ]
  43.  
  44.                 [ ----oooouuuuttttlllleeeevvvveeeellllssss _l_e_v_e_l ]
  45.                 [ ----oooouuuuttttlllleeeevvvveeeelllllllleeeefffftttt _l_e_v_e_l ]    [ ----oooouuuuttttlllleeeevvvveeeellllrrrriiiigggghhhhtttt _l_e_v_e_l ]
  46.  
  47. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  48.      _a_u_d_i_o_p_a_n_e_l provides a graphical interface to control the audio hardware.
  49.  
  50.      The display indicates the state of one or more independent loci of audio
  51.      hardware control known as "devices" and allows control of their signal
  52.      levels, sample rates, and master timing as well as input signal metering
  53.      and monitoring.
  54.  
  55.      The display is loosely divided into two halves; input devices panels with
  56.      their related controls, when displayed, appear on the left half of the
  57.      window and output devices panels and their controls, when summoned,
  58.      appear on the right.  By default, _a_u_d_i_o_p_a_n_e_l initially displays the
  59.      DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt and DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt devices.  The MMMMeeeennnnuuuu BBBBaaaarrrr at the top of the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  71.  
  72.  
  73.  
  74.      window allows complete control of all other audio parameters such as
  75.      SSSSaaaammmmpppplllleeee RRRRaaaatttteeee,,,, IIIInnnnppppuuuutttt SSSSoooouuuurrrrcccceeee and DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt and DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt device
  76.      selection.
  77.  
  78.      DDDDeeeevvvviiiicccceeee PPPPaaaannnneeeellllssss....
  79.  
  80.      All device panels have a title bar labelled with the fully delineated
  81.      name of the device.  Panels for the DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt and DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt
  82.      devices have colored title bars to distinguish them from other devices.
  83.      See the explanation of DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt and DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt devices under the
  84.      section about the DDDDeeeeffffaaaauuuulllltttt MMMMeeeennnnuuuu below.
  85.  
  86.      An IIIInnnn----UUUUsssseeee LED lies to the left of the device name in the device title
  87.      bar.  This LED lights up when an input device is being used for
  88.      collecting audio samples by another application or party other than
  89.      _a_u_d_i_o_p_a_n_e_l, such as a covert government operation.  Output devices also
  90.      have an IIIInnnn----UUUUsssseeee LED which lights up when another application or party is
  91.      sending audio output to that device.  Note that turning metering or
  92.      monitoring on from within _a_u_d_i_o_p_a_n_e_l will not cause the lights to turn
  93.      on, as metering and monitoring are both within the auspices of
  94.      _a_u_d_i_o_p_a_n_e_l's control.
  95.  
  96.      Below the device panel title bar is the name of the currently selected
  97.      iiiinnnntttteeeerrrrffffaaaacccceeee.... An iiiinnnntttteeeerrrrffffaaaacccceeee is one (or a set) of connectors on the back of
  98.      the machine.  For input devices, a single interface (or IIIInnnnppppuuuutttt SSSSoooouuuurrrrcccceeee ) is
  99.      selected at a time, i.e. MMMMiiiiccccrrrroooopppphhhhoooonnnneeee , LLLLiiiinnnneeee IIIInnnn.... For output devices, the
  100.      general rule is that all interfaces are always simultaneously active,
  101.      i.e. HHHHeeeeaaaaddddpppphhhhoooonnnneeee////SSSSppppeeeeaaaakkkkeeeerrrrssss , LLLLiiiinnnneeee OOOOuuuutttt.... However there are exceptions to this
  102.      rule -- whenever the OOOOuuuuttttppppuuuutttt DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn menu is active, the output must
  103.      be selected (see the SSSSeeeelllleeeecccctttteeeedddd MMMMeeeennnnuuuu
  104.       description below).
  105.  
  106.      Below the iiiinnnntttteeeerrrrffffaaaacccceeee name are the controls for the interface.  For input
  107.      devices, these controls consist of mmmmeeeetttteeeerrrrssss and possibly gain sssslllliiiiddddeeeerrrrssss.... For
  108.      output devices, these controls may consist of gain sssslllliiiiddddeeeerrrrssss or no controls
  109.      at all.
  110.  
  111.      If iiiinnnnppppuuuutttt sssslllliiiiddddeeeerrrrssss are present, they control the amount of analog gain
  112.      applied to the signals before the signals are digitized.   Note that
  113.      input devices controlling strictly digital audio signals do not have any
  114.      sliders on their device panels to control analog gain, only mmmmeeeetttteeeerrrrssss....
  115.  
  116.      If oooouuuuttttppppuuuutttt sssslllliiiiddddeeeerrrrssss are present, they control the gain on the output signal
  117.      before going to out to the specified interface, such as the built-in
  118.      SSSSppppeeeeaaaakkkkeeeerrrr or HHHHeeeeaaaaddddpppphhhhoooonnnneeeessss.... As a general rule, these output sliders do not
  119.      effect the line-level output unless otherwise noted by the interface
  120.      name.  Note that output devices controlling strictly digital signals have
  121.      no sliders to control analog gain at all.
  122.  
  123.      Systems using the PPPPrrrreeeesssseeeennnntttteeeerrrr LCD display option will find an extra set of
  124.      controls in their AAAAnnnnaaaalllloooogggg OOOOuuuutttt device to control the volume of the
  125.      Presenter audio system which sports a pair of built-in miniature
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  137.  
  138.  
  139.  
  140.      speakers. The Presenter tone sliders adjusts the brightness and bass on
  141.      both speakers.  Unfortunately, the Presenter levels will track the main
  142.      _a_u_d_i_o_p_a_n_e_l HHHHeeeeaaaaddddpppphhhhoooonnnneeee////SSSSppppeeeeaaaakkkkeeeerrrr level only when _a_u_d_i_o_p_a_n_e_l is running.
  143.  
  144.      Below the interface controls, the current ssssaaaammmmpppplllleeee rrrraaaatttteeee for the device is
  145.      displayed.  If PPPPrrrrooooffffeeeessssssssiiiioooonnnnaaaallll MMMMooooddddeeee is enabled, the name of the device's
  146.      SSSSyyyynnnncccc SSSSoooouuuurrrrcccceeee will be displayed beneath the sampling rate.
  147.  
  148.      There are two check buttons along the bottom of each input device panel.
  149.      Input devices have MMMMeeeetttteeeerrrr and MMMMoooonnnniiiittttoooorrrr buttons. The MMMMeeeetttteeeerrrr button can be
  150.      used to turn the input level meters on or off.  The MMMMoooonnnniiiittttoooorrrr button can be
  151.      used to toggle the connection of a monitoring signal path from the input
  152.      device to the current DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt device.  If either the input and
  153.      output ssssaaaammmmpppplllleeee rrrraaaatttteeeessss or the input and output ssssyyyynnnncccc ssssoooouuuurrrrcccceeeessss are mismatched
  154.      when monitoring is enabled, the output will sound distorted.
  155.  
  156.      Output devices have a single MMMMuuuutttteeee button which is sensitized only if the
  157.      particular output device supports muting.  If sensitized, the MMMMuuuutttteeee button
  158.      can be used to disable output without changing the output level sssslllliiiiddddeeeerrrrssss
  159.      on an output device.  Changing the output levels (using _a_u_d_i_o_p_a_n_e_l or any
  160.      other application) automatically unmutes the hardware.
  161.  
  162.  
  163.      LLLLeeee MMMMeeeennnnuuuu BBBBaaaarrrr....
  164.  
  165.      The menu bar, starring: the FFFFiiiilllleeee , SSSSeeeelllleeeecccctttteeeedddd , VVVViiiieeeewwww , OOOOppppttttiiiioooonnnnssss , DDDDeeeeffffaaaauuuulllltttt
  166.      and HHHHeeeellllpppp menus.
  167.  
  168.      The FFFFiiiilllleeee menu allows the state of the audio hardware and _a_u_d_i_o_p_a_n_e_l
  169.      itself to be stored to or recalled from a file with the OOOOppppeeeennnn , SSSSaaaavvvveeee and
  170.      SSSSaaaavvvveeee AAAAssss............ menu entries.  The FFFFiiiilllleeee menu also has a RRRReeeevvvveeeerrrrtttt menu entry
  171.      which reverts the audio hardware and _a_u_d_i_o_p_a_n_e_l display back to
  172.      reasonable factory defined settings.
  173.  
  174.      SSSSeeeelllleeeecccctttteeeedddd mmmmeeeennnnuuuu....
  175.  
  176.      The SSSSeeeelllleeeecccctttteeeedddd menu operates on the single device currently selected in the
  177.      audio display. Clicking the lllleeeefffftttt mmmmoooouuuusssseeee button just about anywhere in a
  178.      particular ddddeeeevvvviiiicccceeee ppppaaaannnneeeellll will mark that device as currently selected.  The
  179.      currently selected device's panel will have a highlighted border to
  180.      denote the distinction. As a handy shortcut, the SSSSeeeelllleeeecccctttteeeedddd menu for any
  181.      device can be brought up as a pop-up menu by pressing the rrrriiiigggghhhhtttt mmmmoooouuuusssseeee
  182.      button over that device.
  183.  
  184.      The IIIInnnnppppuuuutttt SSSSoooouuuurrrrcccceeee menu allows the selection of one or, at times such as in
  185.      ffffoooouuuurrrr cccchhhhaaaannnnnnnneeeellll mmmmooooddddeeee , a collection of connectors on the back of the machine
  186.      as the input signal source for that device.  The name and number of these
  187.      input sources (also known as iiiinnnnppppuuuutttt iiiinnnntttteeeerrrrffffaaaacccceeeessss ) vary from device to
  188.      device and from machine to machine. If an input device has only one
  189.      choice for an iiiinnnnppppuuuutttt ssssoooouuuurrrrcccceeee , this menu is desensitized.
  190.  
  191.      Similarly, the OOOOuuuuttttppppuuuutttt DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn menu, if active, allows the selection
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  203.  
  204.  
  205.  
  206.      of one or a collection of output connectors to be the output signal
  207.      destination for the device.  Like IIIInnnnppppuuuutttt SSSSoooouuuurrrrcccceeeessss the name and number of
  208.      these output destinations (also known as oooouuuuttttppppuuuutttt iiiinnnntttteeeerrrrffffaaaacccceeeessss ) vary from
  209.      device to device and from machine to machine.  As mentioned earlier, most
  210.      output devices as a general rule will have all of their oooouuuuttttppppuuuutttt iiiinnnntttteeeerrrrffffaaaacccceeeessss
  211.      active simulateously, and therefore will have no need for the OOOOuuuuttttppppuuuutttt
  212.      DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn (consequently deactivated) menu.  However, there are
  213.      exceptions to the rule, and those devices which allow you to choose which
  214.      connector is the output destination will have this menu activated,
  215.      typically for hardware on which 2 or more devices can share a particular
  216.      connector on the back of the machine.
  217.  
  218.      The SSSSaaaammmmpppplllleeee RRRRaaaatttteeee menu contains a list of selectable sample rates for the
  219.      selected device.  The sample rate of a device is the number of times the
  220.      audio signal is sampled in one second.  Higher sample rates can yield a
  221.      higher quality digital signal by increasing the signal's ability to store
  222.      high frequency content.  Audio Compact Discs (CDs) always use a sampling
  223.      rate of 44444444....1111 kkkkHHHHzzzz (44,100 samples per second). Digital Audio Tapes (DATs)
  224.      generally use a sampling rate of 44448888 kkkkHHHHzzzz , although some can also do 44444444....1111
  225.      kkkkHHHHzzzz and some 33332222 kkkkHHHHzzzz.... Digital audio signals coming into or out of the
  226.      machine such as AAAAEEEESSSS can generally handle sample frequencies between 33332222
  227.      kkkkHHHHzzzz and 44448888 kkkkHHHHzzzz.... AAAADDDDAAAATTTT digital audio signals usually operate at 44448888 kkkkHHHHzzzz....
  228.      Choose wisely.
  229.  
  230.      When the device's sample rate is derived from a variable-rate ssssyyyynnnncccc ssssoooouuuurrrrcccceeee
  231.      , such as an AES or ADAT master clock, sample rates are expressed as
  232.      rational fractions of the sync signal.  A value of 1111////1111 is most often
  233.      used, although other useful fractions are provided on the menu.
  234.      1111000000000000////1111000000001111 is commonly used with digital audio signals in the video world.
  235.      111144447777////111166660000 derives a 44.1 kHz sample rate from a sync source rated at 48
  236.      kHz.  333322220000////444444441111 derives a 32 kHz sample rate from a sync source rated at
  237.      44.1 kHz.  2222////3333 derives a 32 kHz sample rate from a sync source rated at
  238.      48 kHz.
  239.  
  240.      The GGGGrrrroooouuuupppp SSSSlllliiiiddddeeeerrrrssss menu entry toggles between grouped and independent
  241.      motion of all the sliders for the selected device.  When this is off each
  242.      slider can be moved without affecting the other sliders. Otherwise,
  243.      moving one slider within the device panel causes all other sliders within
  244.      the same device panel to move by the same amount.
  245.  
  246.      For each device, an entry titled MMMMaaaakkkkeeee DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt or MMMMaaaakkkkeeee DDDDeeeeffffaaaauuuulllltttt
  247.      OOOOuuuuttttppppuuuutttt exists as a convenience for making the selected device the ddddeeeeffffaaaauuuulllltttt
  248.      iiiinnnnppppuuuutttt or ddddeeeeffffaaaauuuulllltttt oooouuuuttttppppuuuutttt device, whichever is applicable.
  249.  
  250.      DDDDeeeevvvviiiicccceeee PPPPrrrreeeeffffeeeerrrreeeennnncccceeee ddddiiiiaaaallllooooggggssss....
  251.  
  252.      Each audio device has a DDDDeeeevvvviiiicccceeee PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss dialog, invoked by selecting
  253.      the PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss............ item in the SSSSeeeelllleeeecccctttteeeedddd menu when the device is the
  254.      current selection.  This dialog contains device specific settings most
  255.      users are likely to change infrequently.
  256.  
  257.      From each Device Preferences dialog, the SSSSyyyynnnncccc SSSSoooouuuurrrrcccceeee (also known as the
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  269.  
  270.  
  271.  
  272.      MMMMaaaasssstttteeeerrrr CCCClllloooocccckkkk ) can be selected from an option menu to govern the overall
  273.      audio device timing.  Available sync sources vary from device to device
  274.      and from machine to machine.  Devices with sync sources labelled IIIInnnntttteeeerrrrnnnnaaaallll
  275.      take their timing from high precision crystal oscillators local to the
  276.      audio hardware subsystem.  Devices having sync sources labelled AAAAEEEESSSS or
  277.      AAAADDDDAAAATTTT derive their sample rates relative to the self-clocking digital
  278.      audio signals of the DDDDiiiiggggiiiittttaaaallll IIIInnnn (also called AAAAEEEESSSS IIIInnnn ) or AAAADDDDAAAATTTT IIIInnnn devices
  279.      on the same audio hardware subsystem.  Digital input devices such as the
  280.      aforementioned DDDDiiiiggggiiiittttaaaallll IIIInnnn (aka AAAAEEEESSSS IIIInnnn ) or AAAADDDDAAAATTTT IIIInnnn typically have their
  281.      input signal as their sole sync source.  For these devices, or any other
  282.      where there is only one available ssssyyyynnnncccc ssssoooouuuurrrrcccceeee for a device, the sync
  283.      source name will be displayed in place of a menu of choices.
  284.  
  285.      The PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss for AAAAnnnnaaaalllloooogggg OOOOuuuutttt devices have the added ability to take the
  286.      current Analog Out sssslllliiiiddddeeeerrrr values and from them set the audio volume to be
  287.      used at bbbbooooooootttt time.
  288.  
  289.      On Indy, Indigo2 machines and Onyx machines with an Audio Serial Option,
  290.      two additional items appear in the PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss DDDDiiiiaaaalllloooogggg for AAAAnnnnaaaalllloooogggg IIIInnnn
  291.      devices.
  292.  
  293.      A FFFFoooouuuurrrr CCCChhhhaaaannnnnnnneeeellll MMMMooooddddeeee option allows switching the hardware between stereo
  294.      operation and four channel operation.  If an AAAAnnnnaaaalllloooogggg IIIInnnn device is in
  295.      stereo mode, this also implies that the AAAAnnnnaaaalllloooogggg OOOOuuuutttt on the same audio
  296.      hardware subsystem is also in four channel mode. In stereo mode, a left
  297.      sssslllliiiiddddeeeerrrr and a right sssslllliiiiddddeeeerrrr will appear in the ddddeeeevvvviiiicccceeee ccccoooonnnnttttrrrroooollllssss section of
  298.      the AAAAnnnnaaaalllloooogggg IIIInnnn device with a pair of input level mmmmeeeetttteeeerrrrssss between the
  299.      sliders.  If the hardware is in ffffoooouuuurrrr cccchhhhaaaannnnnnnneeeellll mmmmooooddddeeee , two left/right pairs
  300.      of sssslllliiiiddddeeeerrrrssss will be present, with a pair of level mmmmeeeetttteeeerrrrssss for each. Also,
  301.      the AAAAnnnnaaaalllloooogggg OOOOuuuutttt gain controls are disabled, as all of its output channels
  302.      become line-level outputs.  In ffffoooouuuurrrr cccchhhhaaaannnnnnnneeeellll mmmmooooddddeeee , selecting MMMMiiiiccccrrrroooopppphhhhoooonnnneeee
  303.      as the input source for the device causes the L2 and R2 inputs to operate
  304.      as microphone inputs and selecting LLLLiiiinnnneeee IIIInnnn as the input causes the L2 and
  305.      R2 inputs to operate as line level inputs.  Inputs L1 and R1 are always
  306.      line level inputs in ffffoooouuuurrrr cccchhhhaaaannnnnnnneeeellll mmmmooooddddeeee....
  307.  
  308.      A SSSStttteeeerrrreeeeoooo MMMMiiiiccccrrrroooopppphhhhoooonnnneeee option selects whether the microphone input source is
  309.      treated as a mono microphone or a stereo microphone.  In mono mode the
  310.      microphone input is assumed to have valid signal on the left side only,
  311.      and the left input signal is copied to the right input.  In stereo mode
  312.      the microphone input is treated as two independent signals on the left
  313.      and right.
  314.  
  315.      VVVViiiieeeewwww mmmmeeeennnnuuuu //// DDDDeeeevvvviiiicccceeee LLLLiiiisssstttt ppppaaaannnneeeellll....
  316.  
  317.      The VVVViiiieeeewwww menu provides a means of toggling any audio device on the system
  318.      into the main _a_u_d_i_o_p_a_n_e_l view.  Toggling on individual device entries,
  319.      such as AAAAnnnnaaaalllloooogggg IIIInnnn or DDDDiiiiggggiiiittttaaaallll OOOOuuuutttt , causes the named device to be shown
  320.      _b_e_c_a_u_s_e _i_t _i_s _t_h_e _s_p_e_c_i_f_i_e_d _d_e_v_i_c_e.  However, toggling on the DDDDeeeeffffaaaauuuulllltttt
  321.      IIIInnnnppppuuuutttt or DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt menu entries cause a device to be displayed
  322.      _b_e_c_a_u_s_e _i_t _i_s _t_h_e _d_e_f_a_u_l_t _d_e_v_i_c_e.  If a given default device toggle on
  323.      and the default device changes, the control panel for the new default
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  335.  
  336.  
  337.  
  338.      device will replace that of the old.  If a device is a default device and
  339.      both the toggles for the specific device and default device are on,
  340.      switching only one of the toggles off is not sufficient for removing the
  341.      device from view, as this leaves the other toggle on, indicating to
  342.      _a_u_d_i_o_p_a_n_e_l that you still want the device displayed for another reason.
  343.  
  344.      For times when many device panels need to be manipulated at once, the
  345.      SSSShhhhoooowwww DDDDeeeevvvviiiicccceeee LLLLiiiisssstttt toggle adds or hides a toggle panel to the view to save
  346.      you repeated trips to the View menu.
  347.  
  348.      OOOOppppttttiiiioooonnnnssss mmmmeeeennnnuuuu....
  349.  
  350.      The AAAAuuuuddddiiiioooo QQQQuuuueeeeuuuueeee MMMMoooonnnniiiittttoooorrrr menu entry launches a program to that monitors
  351.      the queues of audio applications running on the system. See _r_b_v_i_e_w(1) for
  352.      more details.
  353.  
  354.      The PPPPrrrrooooffffeeeessssssssiiiioooonnnnaaaallll MMMMooooddddeeee toggle turns on and off the ability to display and
  355.      change ssssyyyynnnncccc ssssoooouuuurrrrcccceeeessss.... Since SSSSyyyynnnncccc SSSSoooouuuurrrrcccceeeessss are considered an advanced
  356.      feature and can change the effect of the timing and overall sample rate
  357.      of the device, it's best not to mess with these unless you know what
  358.      you're getting yourself into.
  359.  
  360.      DDDDeeeecccciiiibbbbeeeellll SSSSccccaaaalllleeee toggles the display of decibel units (in units of dBV)
  361.      alongside gain sliders on input and output devices in place of the more
  362.      straightforward 0 to 10 scale.
  363.  
  364.      In the continuing pixel conservation effort, the SSSShhhhoooowwww SSSSccccrrrroooollllllllbbbbaaaarrrr entry
  365.      toggles the display of the scrollbar allowing you to browse through
  366.      displays with hordes of devices.  Also joining this effort is the SSSShhhhoooowwww
  367.      QQQQuuuuiiiicccckkkk HHHHeeeellllpppp toggle, which usurps or relinquishes screen real-estate for
  368.      handy context-sensitive help messages.
  369.  
  370.      TTTThhhheeee DDDDeeeeffffaaaauuuulllltttt mmmmeeeennnnuuuu....
  371.  
  372.      The DDDDeeeeffffaaaauuuulllltttt menu contains two submenus. One, marked IIIInnnnppppuuuutttt , contains a
  373.      radio-style submenu of all the input devices. The other, curiously enough
  374.      marked OOOOuuuuttttppppuuuutttt , contains a similar radio-style submenu of all the output
  375.      devices.  When one of these entries is chosen, that device becomes the
  376.      DDDDeeeeffffaaaauuuulllltttt DDDDeeeevvvviiiicccceeee....
  377.  
  378.      The DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt device is the single input device from which an
  379.      application gets all audio input data and control information, unless
  380.      otherwise specified by/to an application.  Similarly, the DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt
  381.      device is the single output device to which an application sends all
  382.      audio output data and control information, unless otherwise specified
  383.      by/to an application.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  401.  
  402.  
  403.  
  404. NUTRITION FACTS
  405.      for All-New, Low-Sodium, Diet _a_u_d_i_o_p_a_n_e_l
  406.  
  407.      Not a significant source of Vitamin A, Vitamin C, Calcium or Iron.
  408.  
  409.      Ingredients: Months, sweat, Motif, _V_i_e_w_K_i_t, TLC (a preservative), Audio
  410.      Library 2.0, caffeine, Xt, fried DEF (a preservative), Xlib, cooked funky
  411.      niblets (a preservative), _m_a_t_h, red dye #5 (an artificial coloring),
  412.      grace (a preservative), partially hydrogenated chupacabra oil.
  413.  
  414.  
  415. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  416.      AAAApppppppplllliiiiccccaaaattttiiiioooonnnn----WWWWiiiiddddeeee CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss....
  417.  
  418.      These command line options perform their respective tasks regardless of
  419.      the order they appear in the command line.
  420.  
  421.      ----ddddeeeeffffaaaauuuullllttttiiiinnnn _d_e_v_i_c_e_n_a_m_e
  422.            Sets the default audio input to _d_e_v_i_c_e_n_a_m_e.
  423.  
  424.      ----ddddeeeeffffaaaauuuullllttttoooouuuutttt _d_e_v_i_c_e_n_a_m_e
  425.            Sets the default audio output to _d_e_v_i_c_e_n_a_m_e.
  426.  
  427.      ----ddddeeeevvvviiiicccceeeelllliiiissssttttooooffffffff
  428.            Initialize _a_u_d_i_o_p_a_n_e_l display not showing the audio device
  429.            selection list.
  430.  
  431.      ----ddddeeeevvvviiiicccceeeelllliiiissssttttoooonnnn
  432.            Initialize _a_u_d_i_o_p_a_n_e_l display showing the audio device selection
  433.            list.
  434.  
  435.      ----hhhhiiiiddddeeeeddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e [, _d_e_v_i_c_e_n_a_m_e_2, ... ]
  436.            In the initial _a_u_d_i_o_p_a_n_e_l display, do not show the devices in the
  437.            comma-separated list. _D_e_v_i_c_e_n_a_m_es may have spaces in them.  Valid
  438.            _d_e_v_i_c_e_n_a_m_es can be seen with the ----pppprrrriiiinnnntttt option.
  439.  
  440.      ----iiiiccccoooonnnniiiicccc
  441.            Bring up application in iconized state.
  442.  
  443.      ----nnnnooooddddiiiissssppppllllaaaayyyy
  444.            Process command-line options but do not bring up _a_u_d_i_o_p_a_n_e_l'_s
  445.            visual display.  Option implicit in absence or NULL value of
  446.            DISPLAY environment variable.
  447.  
  448.      ----nnnnooooffffoooorrrrkkkk
  449.            Do not go into the background.  By default, _a_u_d_i_o_p_a_n_e_l forks itself
  450.            to give control back to the shell.
  451.  
  452.      ----ooooppppeeeennnnffffiiiilllleeee _f_i_l_e_n_a_m_e
  453.            File _f_i_l_e_n_a_m_e contains parameters for audio hardware and _a_u_d_i_o_p_a_n_e_l
  454.            state.
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  467.  
  468.  
  469.  
  470.      ----ppppoooolllllllliiiinnnntttteeeerrrrvvvvaaaallll _t_i_m_e
  471.            Initialize _a_u_d_i_o_p_a_n_e_l to poll audio hardware state every _t_i_m_e
  472.            milliseconds.  Values greater than 0 are valid.
  473.  
  474.      ----pppprrrreeeesssseeeennnntttteeeerrrrlllleeeevvvveeeellllssss _l_e_v_e_l
  475.            Set Presenter flat panel display speaker levels to _l_e_v_e_l if it
  476.            exists on the machine.
  477.            Valid integers in range {0..26}.
  478.  
  479.      ----pppprrrreeeesssseeeennnntttteeeerrrrmmmmuuuutttteeeeoooonnnn
  480.            Turn Presenter flat panel display speaker mute on if it exists on
  481.            the machine.
  482.  
  483.      ----pppprrrreeeesssseeeennnntttteeeerrrrmmmmuuuutttteeeeooooffffffff
  484.            Turn Presenter flat panel display speaker mute off if it exists on
  485.            the machine.
  486.  
  487.      ----pppprrrreeeesssseeeennnntttteeeerrrrttttoooonnnneeee _t_o_n_e
  488.            Set Presenter flat panel display speaker tone to _l_e_v_e_l if it exists
  489.            on the machine.
  490.            Valid integers in range {0..9}.
  491.  
  492.      ----pppprrrriiiinnnntttt
  493.            Print audio hardware state in Audio Library parameter values to
  494.            shell and exit.
  495.  
  496.      ----pppprrrroooommmmooooddddeeeeooooffffffff
  497.            Initialize the display to not show professional settings. For now
  498.            this encompasses only the display of the sync source for each audio
  499.            device.
  500.  
  501.      ----pppprrrroooommmmooooddddeeeeoooonnnn
  502.            Initialize the display to show professional settings. For now this
  503.            encompasses only the display of the sync source for each audio
  504.            device.
  505.  
  506.      ----ssssaaaavvvveeeeffffiiiilllleeee _f_i_l_e_n_a_m_e
  507.            Store the _a_u_d_i_o_p_a_n_e_l preferences and a snapshot of the hardware
  508.            state in the file _f_i_l_e_n_a_m_e.
  509.  
  510.      ----ssssccccrrrroooollllllllbbbbaaaarrrrooooffffffff
  511.            Initialize the display to not show the scrollbar for the audio
  512.            device panels.
  513.  
  514.      ----ssssccccrrrroooollllllllbbbbaaaarrrroooonnnn
  515.            Initialize the display to show the scrollbar for the audio device
  516.            panels.
  517.  
  518.      ----sssshhhhoooowwwwddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e [, _d_e_v_i_c_e_n_a_m_e_2, ... ]
  519.            In the initial display, show the comma-separated list of audio
  520.            devices.  _D_e_v_i_c_e_n_a_m_es may have spaces in them.  Valid _d_e_v_i_c_e_n_a_m_es
  521.            can be seen with the ----pppprrrriiiinnnntttt option.
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  533.  
  534.  
  535.  
  536.      ----qqqquuuuiiiicccckkkkhhhheeeellllppppoooonnnn
  537.            Initialize the display to show message line help (aka Quick Help)
  538.            at the bottom of the display.
  539.  
  540.      ----qqqquuuuiiiicccckkkkhhhheeeellllppppooooffffffff
  541.            Initialize the display to not show message line help (aka Quick
  542.            Help) at the bottom of the display.
  543.  
  544.  
  545.      CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnn DDDDeeeelllliiiimmmmiiiitttteeeerrrrssss
  546.  
  547.  
  548.      ----ddddeeeevvvviiiicccceeee _d_e_v_i_c_e_n_a_m_e
  549.            Confines the scope of subsequent command line options to setting
  550.            the audio state of _d_e_v_i_c_e_n_a_m_e until the occurrence of another
  551.            ----ddddeeeevvvviiiicccceeee or ----iiiinnnntttteeeerrrrffffaaaacccceeee delimiter later on in the command line
  552.            changes the scope again.  If no ----ddddeeeevvvviiiicccceeee option is given, command
  553.            line options will effect the DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt or DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt audio
  554.            device, whichever is appropriate for the given argument.  Valid
  555.            values for _d_e_v_i_c_e_n_a_m_e are DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt, DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt, as well as
  556.            any specific device name shown by the ----pppprrrriiiinnnntttt option or the
  557.            _a_u_d_i_o_p_a_n_e_l user-interface device panel title.
  558.  
  559.      ----iiiinnnntttteeeerrrrffffaaaacccceeee _i_n_t_e_r_f_a_c_e_n_a_m_e
  560.            Confines the scope of subsequent command line options to setting
  561.            the audio state of _i_n_t_e_r_f_a_c_e_n_a_m_e until the occurrence of another
  562.            ----iiiinnnntttteeeerrrrffffaaaacccceeee delimiter later on in the command line changes the scope
  563.            again.  If no ----iiiinnnntttteeeerrrrffffaaaacccceeee option is given, command line options will
  564.            effect either the current input interface of the audio device
  565.            specified by ----ddddeeeevvvviiiicccceeee, the DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt audio device or all of the
  566.            output interfaces of the DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt audio device, whichever is
  567.            appropriate given the argument and previous delimiters.  Valid
  568.            values for _i_n_t_e_r_f_a_c_e_n_a_m_e are any specific interface name shown by
  569.            the ----pppprrrriiiinnnntttt option for a given device, or names found in the
  570.            _a_u_d_i_o_p_a_n_e_l user-interface interface selection for a device panel.
  571.  
  572.  
  573.      DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  574.  
  575.  
  576.      ----ddddbbbbssssccccaaaalllleeee
  577.            Use a decibel (dB) scale for level sliders of the previously
  578.            specified device.
  579.  
  580.      ----ddddeeeeccccaaaaddddeeeessssccccaaaalllleeee
  581.            Use a decade scale [1..10] for all level sliders of the previously
  582.            specified device.
  583.  
  584.      ----ggggrrrroooouuuuppppsssslllliiiiddddeeeerrrrssss
  585.            Configure the device sliders to move together as a set when one
  586.            slider is moved.
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  599.  
  600.  
  601.  
  602.      ----hhhhiiiiddddeeee
  603.            In the initial display, do not show the device.
  604.  
  605.      ----nnnncccchhhhaaaannnnssss _c_h_a_n_n_e_l_s
  606.            Switch the hardware to the mode described by _c_h_a_n_n_e_l_s.  Valid modes
  607.            are 2 and 4, the latter available on Indigo2 and Indy only.
  608.  
  609.      ----rrrraaaatttteeee _r_a_t_e
  610.            Initialize the device sampling rate to _r_a_t_e.
  611.  
  612.      ----sssshhhhoooowwww
  613.            In the initial display, show the device.
  614.  
  615.      ----ssssyyyynnnnccccssssoooouuuurrrrcccceeee _s_y_n_c_n_a_m_e
  616.            Initialize the sync source (aka master clock) to _s_y_n_c_n_a_m_e. Valid
  617.            values for syncname can be obtained from the ----pppprrrriiiinnnntttt option, or from
  618.            the selections available through the sync menu on the PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss
  619.            panel for the given device.
  620.  
  621.      ----uuuunnnnggggrrrroooouuuuppppsssslllliiiiddddeeeerrrrssss
  622.            Configure the device's sliders to move independently.
  623.  
  624.      ----ssssoooouuuurrrrcccceeee _i_n_t_e_r_f_a_c_e_n_a_m_e
  625.            Initialize input source or output destination to _i_n_t_e_r_f_a_c_e_n_a_m_e.
  626.  
  627.            Valid values for _i_n_t_e_r_f_a_c_e_n_a_m_e depend on the input or output
  628.            device. Check the ----pppprrrriiiinnnntttt option, the input device's Input Source
  629.            menu, or the output device's Output Destination menu for the values
  630.            valid for a particular device.
  631.  
  632.  
  633.      IIIInnnnppppuuuutttt DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  634.  
  635.  
  636.      ----ggggaaaannnnggggiiiinnnnppppuuuutttt
  637.            Configure the sliders for the input device to move together as a
  638.            set when one slider is moved.
  639.  
  640.      ----iiiinnnnrrrraaaatttteeee _r_a_t_e
  641.            Initialize input device's sampling rate to _r_a_t_e.
  642.  
  643.      ----mmmmeeeetttteeeerrrroooonnnn
  644.            Enable level meters for the input device.
  645.  
  646.      ----mmmmeeeetttteeeerrrrooooffffffff
  647.            Disable input level meters for the input device.
  648.  
  649.      ----mmmmiiiiccccmmmmooooddddeeee _m_o_d_e
  650.            Initialize microphone mode for the input device to _m_o_d_e.  Valid
  651.            modes are mono and stereo.  Available on Indigo2 and Indy only.
  652.            This option is for compatibility with scripts using previous
  653.            versions of _a_u_d_i_o_p_a_n_e_l. Use the ----cccchhhhaaaannnnnnnneeeellllssss option for the
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  665.  
  666.  
  667.  
  668.            appropriate iiiinnnntttteeeerrrrffffaaaacccceeee with a value of 1 (for mono) or 2 (for
  669.            stereo) instead.
  670.  
  671.      ----mmmmoooonnnniiiittttoooorrrroooonnnn
  672.            Enable a monitoring connection between the input device and the
  673.            Default Output device.
  674.  
  675.      ----mmmmoooonnnniiiittttoooorrrrooooffffffff
  676.            Disable the monitoring connection between the input device and the
  677.            Default Output device.
  678.  
  679.      ----uuuunnnnggggaaaannnnggggiiiinnnnppppuuuutttt
  680.            Configure the input device's sliders to move independently.
  681.  
  682.  
  683.      OOOOuuuuttttppppuuuutttt DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  684.  
  685.  
  686.      ----ggggaaaannnnggggoooouuuuttttppppuuuutttt
  687.            Configure the output sliders to move together as a set when one
  688.            slider is moved.
  689.  
  690.      ----mmmmuuuutttteeee
  691.            Mute the specified output interface (if it supports mute).
  692.  
  693.      ----oooouuuuttttrrrraaaatttteeee _r_a_t_e
  694.            Initialize output device's sampling rate to _r_a_t_e.
  695.  
  696.      ----pppprrrroooossssuuuubbbbccccooooddddeeeeooooffffffff
  697.            Initialize output device's Channel Status Subcode for IEC958
  698.            Consumer Use (S/PDIF)
  699.  
  700.      ----pppprrrroooossssuuuubbbbccccooooddddeeeeoooonnnn
  701.            Initialize output device's Channel Status Subcode for IEC958
  702.            Professional Use (AES3)
  703.  
  704.      ----uuuunnnnggggaaaannnnggggoooouuuuttttppppuuuutttt
  705.            Configure the output sliders as independent.
  706.  
  707.      ----uuuunnnnmmmmuuuutttteeee
  708.            Unmute the specified output interface (if it supports mute).
  709.  
  710.  
  711.      IIIInnnntttteeeerrrrffffaaaacccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  712.  
  713.  
  714.      ----ggggaaaaiiiinnnn _d_B_l_e_v_e_l [ _d_B_l_e_v_e_l_2 ... ]
  715.            Initialize the previously specified input or output interface gain
  716.            levels to the array of _d_B_l_e_v_e_l values. Values are floating point,
  717.            in units of dB. The range of valid values depend on the interface
  718.            being effected and are queryable via the ----pppprrrriiiinnnntttt option. A special
  719.            value of ----iiiinnnnffffiiiinnnniiiittttyyyy is accepted for interfaces that support it.
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  731.  
  732.  
  733.  
  734.            Floating point values with the percent (%%%%) character indicate gains
  735.            as percentage of full scale with lowest gain being 0.0% and highest
  736.            being 100.0%.  The maximum length of the _d_B_l_e_v_e_l array depends on
  737.            the number of channels of the interface being effected. For all
  738.            interfaces, if only a single value is specified, the gain of every
  739.            channel of the interface is initialized to _d_B_l_e_v_e_l.
  740.  
  741.      ----cccchhhhaaaannnnnnnneeeellllssss _n_u_m_c_h_a_n_n_e_l_s
  742.            Initialize the interface to have _n_u_m_c_h_a_n_n_e_l_s channels.
  743.  
  744.  
  745.      IIIInnnnppppuuuutttt IIIInnnntttteeeerrrrffffaaaacccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  746.  
  747.  
  748.      ----iiiinnnnlllleeeevvvveeeellllssss _l_e_v_e_l
  749.            Initialize input levels to _l_e_v_e_l.  Valid integers in range
  750.            {0..255}.  This option remains for compatibility with scripts using
  751.            previous versions of audiopanel. Use the ----ggggaaaaiiiinnnn option instead.
  752.  
  753.      ----iiiinnnnlllleeeevvvveeeelllllllleeeefffftttt1111 _l_e_v_e_l
  754.            Initialize line 1 left input level to _l_e_v_e_l.  Valid integers in
  755.            range {0..255}.  This option remains for compatibility with scripts
  756.            using previous versions of audiopanel. Use the ----ggggaaaaiiiinnnn option
  757.            instead.
  758.  
  759.      ----iiiinnnnlllleeeevvvveeeellllrrrriiiigggghhhhtttt1111 _l_e_v_e_l
  760.            Initialize line 1 right input level to _l_e_v_e_l.
  761.            Valid integers in range {0..255}.  This option remains for
  762.            compatibility with scripts using previous versions of audiopanel.
  763.            Use the ----ggggaaaaiiiinnnn option instead.
  764.  
  765.      ----iiiinnnnlllleeeevvvveeeelllllllleeeefffftttt2222 _l_e_v_e_l
  766.            Initialize the line 2 left input level to _l_e_v_e_l.
  767.            Valid integers in range {0..255}.  This option remains for
  768.            compatibility with scripts using previous versions of audiopanel.
  769.            Use the ----ggggaaaaiiiinnnn option instead.
  770.  
  771.      ----iiiinnnnlllleeeevvvveeeellllrrrriiiigggghhhhtttt2222 _l_e_v_e_l
  772.            Initialize line 2 right input level to _l_e_v_e_l.
  773.            Valid integers in range {0..255}.  This option remains for
  774.            compatibility with scripts using previous versions of audiopanel.
  775.            Use the ----ggggaaaaiiiinnnn option instead.
  776.  
  777.  
  778.      OOOOuuuuttttppppuuuutttt IIIInnnntttteeeerrrrffffaaaacccceeee SSSSppppeeeecccciiiiffffiiiicccc CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  779.  
  780.  
  781.      ----oooouuuuttttlllleeeevvvveeeellllssss _l_e_v_e_l
  782.            Initialize output levels to _l_e_v_e_l.
  783.            Valid integers in range {0..255}.  This option remains for
  784.            compatibility with scripts using previous versions of audiopanel.
  785.            Use the ----ggggaaaaiiiinnnn option instead.
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  797.  
  798.  
  799.  
  800.      ----oooouuuuttttlllleeeevvvveeeelllllllleeeefffftttt _l_e_v_e_l
  801.            Initialize left output level to _l_e_v_e_l.
  802.            Valid integers in range {0..255}.  This option remains for
  803.            compatibility with scripts using previous versions of audiopanel.
  804.            Use the ----ggggaaaaiiiinnnn option instead.
  805.  
  806.      ----oooouuuuttttlllleeeevvvveeeellllrrrriiiigggghhhhtttt _l_e_v_e_l
  807.            Initialize right output level to _l_e_v_e_l.
  808.            Valid integers in range {0..255}.  This option remains for
  809.            compatibility with scripts using previous versions of audiopanel.
  810.            Use the ----ggggaaaaiiiinnnn option instead.
  811.  
  812.  
  813. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  814.      To print audio hardware state:
  815.  
  816.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----pppprrrriiiinnnntttt
  817.  
  818.      To change the default input to DDDDiiiiggggiiiittttaaaallll IIIInnnn on subsystem AAAA2222:
  819.  
  820.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----ddddeeeeffffaaaauuuullllttttiiiinnnn AAAA2222....DDDDiiiiggggiiiittttaaaallll IIIInnnn
  821.  
  822.      To bring up _a_u_d_i_o_p_a_n_e_l with the DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt, DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt and DDDDiiiiggggiiiittttaaaallll
  823.      IIIInnnn devices in view:
  824.  
  825.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----sssshhhhoooowwwwddddeeeevvvviiiicccceeee DDDDeeeeffffaaaauuuulllltttt IIIInnnnppppuuuutttt,,,, DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt,,,, DDDDiiiiggggiiiittttaaaallll IIIInnnn
  826.  
  827.      To bring up _a_u_d_i_o_p_a_n_e_l with the _A_n_a_l_o_g _I_n device's rate set to 44.1 kHz
  828.      for playing CD's:
  829.  
  830.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----ddddeeeevvvviiiicccceeee AAAAnnnnaaaalllloooogggg IIIInnnn ----rrrraaaatttteeee 44444444111100000000
  831.  
  832.      To bring up _a_u_d_i_o_p_a_n_e_l with the _A_n_a_l_o_g _O_u_t device's left speaker gain set
  833.      to 0 dB and the right speaker gain set to -infinity:
  834.  
  835.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----ddddeeeevvvviiiicccceeee AAAAnnnnaaaalllloooogggg OOOOuuuutttt ----ggggaaaaiiiinnnn 0000....0000 ----iiiinnnnffff
  836.  
  837.      To bring up _a_u_d_i_o_p_a_n_e_l with the AAAAnnnnaaaalllloooogggg IIIInnnn device's MMMMiiiiccccrrrroooopppphhhhoooonnnneeee interface
  838.      as the input source, with a monitor connection enabled and the AAAAnnnnaaaalllloooogggg OOOOuuuutttt
  839.      device's output gain to be at half volume, all without using the
  840.      graphical user interface:
  841.  
  842.      aaaauuuuddddiiiiooooppppaaaannnneeeellll ----nnnnooooddddiiiissssppppllllaaaayyyy ----ddddeeeevvvviiiicccceeee AAAAnnnnaaaalllloooogggg IIIInnnn ----mmmmoooonnnniiiittttoooorrrr ----ssssoooouuuurrrrcccceeee MMMMiiiiccccrrrroooopppphhhhoooonnnneeee
  843.      ----ddddeeeevvvviiiicccceeee AAAAnnnnaaaalllloooogggg OOOOuuuutttt ----ggggaaaaiiiinnnn 55550000%%%%
  844.  
  845.  
  846. XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  847.      Below, aaaapppppppplllliiiiccccaaaattttiiiioooonnnn----wwwwiiiiddddeeee resources effect the entire application. DDDDeeeevvvviiiicccceeee----
  848.      ssssppppeeeecccciiiiffffiiiicccc and iiiinnnntttteeeerrrrffffaaaacccceeee----ssssppppeeeecccciiiiffffiiiicccc resources can be prepended with the valid
  849.      X(1) resource instance hierarchy describing the names of audio
  850.      subsystems, devices, and/or interfaces in a manner common in X(1)
  851.      resource files, e.g.
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  863.  
  864.  
  865.  
  866.      AAAAppppaaaannnneeeellll****<<<<ssssuuuubbbbssssyyyysssstttteeeemmmmnnnnaaaammmmeeee>>>>****<<<<ddddeeeevvvviiiicccceeeennnnaaaammmmeeee>>>>****<<<<iiiinnnntttteeeerrrrffffaaaacccceeeennnnaaaammmmeeee>>>>****rrrreeeessssoooouuuurrrrcccceeeennnnaaaammmmeeee:::: vvvvaaaalllluuuueeee
  867.  
  868.      For compatibility with the X resource scheme, periods/decimal points are
  869.      stripped from the audio instance names so that the corresponding X(1)
  870.      resources will resolve correctly.
  871.  
  872.      A resource default value of PPPPoooolllllllleeeedddd means _a_u_d_i_o_p_a_n_e_l normally queries the
  873.      audio hardware for this value on startup.
  874.  
  875.      NNNNaaaammmmeeee               AAAArrrrgggguuuummmmeeeennnntttt TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt
  876.  
  877.      AAAApppppppplllliiiiccccaaaattttiiiioooonnnn----WWWWiiiiddddeeee rrrreeeessssoooouuuurrrrcccceeeessss::::
  878.      autoFork                        Boolean         True
  879.      defaultInput                    String          Polled
  880.      defaultOutput                   String          Polled
  881.      initPresenterLevels             Integer         Polled
  882.      initPresenterTone               Integer         Polled
  883.      displayDevices                  String    DefaultInput, DefaultOutput
  884.      showDevicePanel                 Boolean         False
  885.      professionalMode                Boolean         False
  886.      showScrollbar                   Boolean         False
  887.      showHelpLine                    Boolean         True
  888.      noDisplay                       Boolean         False
  889.      noUnique                        Boolean         False
  890.      iconify                         Boolean         False
  891.      openFileName                    String          None
  892.      saveFileName                    String          None
  893.  
  894.      DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss::::
  895.      initSamplingRate                Float           Polled
  896.      initSyncSource                  String          Polled
  897.      groupSliders                    Boolean         True
  898.      dbScale                         Boolean         False
  899.      decadeScale                     Boolean         True
  900.  
  901.      IIIInnnnppppuuuutttt DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss::::
  902.      initInputSource                 String          Polled
  903.      initMonitor                     Boolean         Polled
  904.      initMeter                       Boolean         False
  905.      inputMeterDCFilter              Boolean         True
  906.  
  907.      OOOOuuuuttttppppuuuutttt DDDDeeeevvvviiiicccceeee SSSSppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss::::
  908.      initOutputDestination           String          Polled
  909.      initMute                        Boolean         Polled
  910.      initProSubcode                  Boolean         Polled
  911.  
  912.      IIIInnnntttteeeerrrrffffaaaacccceeee SSSSppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss::::
  913.      initChannels                    Integer         Polled
  914.      initGain                        Float Array     Polled
  915.  
  916.      OOOOuuuuttttppppuuuutttt IIIInnnntttteeeerrrrffffaaaacccceeee SSSSppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss::::
  917.      <None>
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  929.  
  930.  
  931.  
  932.      It should be noted that when command-line options and X resources are
  933.      mixed, _a_u_d_i_o_p_a_n_e_l uses a defaults precedence scheme. The myriad of
  934.      X/Xt/Motif defaults files are always of least precedence.  A resource
  935.      file specified by the ----ooooppppeeeennnnffffiiiilllleeee command line option would take an
  936.      intermediate precedence level. Should an ----ooooppppeeeennnnffffiiiilllleeee option not be
  937.      specified on the command line, _a_u_d_i_o_p_a_n_e_l will poll the audio hardware
  938.      for audio system state information, but look for layout and display
  939.      information in the user's ~~~~////....aaaauuuuddddiiiiooooppppaaaannnneeeellllrrrrcccc file, also at the intermediate
  940.      precedence level.  Any command line option will always override anything
  941.      set in the ----ooooppppeeeennnnffffiiiilllleeee or ~~~~////....aaaauuuuddddiiiiooooppppaaaannnneeeellllrrrrcccc files.
  942.  
  943.      Hints on tuning _a_u_d_i_o_p_a_n_e_l's look and feel can be found in the
  944.      application default resource file ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////AAAAppppaaaannnneeeellll.
  945.  
  946.  
  947.  
  948. HHHHAAAARRRRDDDDWWWWAAAARRRREEEE
  949.      _a_u_d_i_o_p_a_n_e_l works only on Indigo2, Indy, O2, Octane, Origin machines,
  950.      Onyx/Challenge machines fitted with the Audio/Serial Option, and machines
  951.      with the RADical PCI option card.
  952.  
  953.  
  954. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  955.      _a_u_d_i_o_p_a_n_e_l requires its host machine to be running a new-style audio
  956.      driver and a least IRIX 6.3. If _a_u_d_i_o_p_a_n_e_l execution is attempted on a
  957.      system that does not have a new-style audio driver, an error message such
  958.      as " TTTThhhhiiiissss mmmmaaaacccchhhhiiiinnnneeee hhhhaaaassss nnnnoooo aaaauuuuddddiiiioooo ddddrrrriiiivvvveeeerrrr ssssuuuuppppppppoooorrrrttttiiiinnnngggg AAAAuuuuddddiiiioooo LLLLiiiibbbbrrrraaaarrrryyyy 2222....0000.... IIIIRRRRIIIIXXXX
  959.      6666....3333 iiiissss rrrreeeeqqqquuuuiiiirrrreeeedddd" is posted.  If no audio driver can be detected on the
  960.      system at all, a message such as TTTThhhhiiiissss mmmmaaaacccchhhhiiiinnnneeee hhhhaaaassss nnnnoooo aaaauuuuddddiiiioooo ddddrrrriiiivvvveeeerrrr aaaatttt aaaallllllll....
  961.      is posted.
  962.  
  963.  
  964. NNNNOOOOTTTTEEEESSSS
  965.      While mmmmoooonnnniiiittttoooorrrriiiinnnngggg the audio of an input device on the DDDDeeeeffffaaaauuuulllltttt OOOOuuuuttttppppuuuutttt , if
  966.      the ssssaaaammmmpppplllleeee rrrraaaatttteeeessss or the ssssyyyynnnncccc ssssoooouuuurrrrcccceeeessss of the two devices are mismatched,
  967.      the audio driver's sample rate matching may not be able to keep up and
  968.      static may result on the default output.  To rectify the situation, make
  969.      sure ssssaaaammmmpppplllleeee rrrraaaatttteeeessss and ssssyyyynnnncccc ssssoooouuuurrrrcccceeeessss match.
  970.  
  971.      Previous incarnations of _a_u_d_i_o_p_a_n_e_l had a choice of a DDDDiiiiggggiiiittttaaaallll IIIInnnnppppuuuutttt in
  972.      the IIIInnnnppppuuuutttt ssssoooouuuurrrrcccceeee menu for Indy, Indigo2 and the Onyx Audio/Serial Option.
  973.      Under the new audio architecture, the input source DDDDiiiiggggiiiittttaaaallll IIIInnnnppppuuuutttt is now
  974.      handled as its own device, called DDDDiiiiggggiiiittttaaaallll IIIInnnn , which is independent of
  975.      the AAAAnnnnaaaalllloooogggg IIIInnnn device. Setting the ddddeeeeffffaaaauuuulllltttt iiiinnnnppppuuuutttt to the DDDDiiiiggggiiiittttaaaallll IIIInnnn device
  976.      on these machines will provide the same functionality as switching the
  977.      previous _a_u_d_i_o_p_a_n_e_l's iiiinnnnppppuuuutttt ssssoooouuuurrrrcccceeee to DDDDiiiiggggiiiittttaaaallll IIIInnnn....
  978.  
  979.      On machines with a single audio hardware subsystem, each device will have
  980.      a unique name, i.e. AAAAnnnnaaaalllloooogggg IIIInnnn multiple audio subsystems, these device
  981.      names are not guaranteed to be unique on their own. In the case of a
  982.      device name not being unique unto the system, the name of the audio
  983.      hardware subsystem is displayed preceding the name of the device,
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))                                                    aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111))))
  995.  
  996.  
  997.  
  998.      separated by a period. For example,
  999.  
  1000.      AAAA2222....AAAAnnnnaaaalllloooogggg IIIInnnn and RRRRAAAADDDD....AAAAnnnnaaaalllloooogggg IIIInnnn might be two distinct devices having the
  1001.      same name, but residing on two different audio subsystems.  The same
  1002.      naming scheme is applied to SSSSyyyynnnncccc SSSSoooouuuurrrrcccceeeessss (aka MMMMaaaasssstttteeeerrrr CCCClllloooocccckkkkssss ) with non-
  1003.      unique names that reside on different subsystems.
  1004.  
  1005.      Previous incarnations of _a_u_d_i_o_p_a_n_e_l had a UUUUsssseeee IIIInnnnppppuuuutttt RRRRaaaatttteeee option as part
  1006.      of the output ssssaaaammmmpppplllleeee rrrraaaatttteeee menu.  Unfortunately, this convenience feature
  1007.      is not available in this newer version.
  1008.  
  1009.      Tampering with _a_u_d_i_o_p_a_n_e_l in airplane lavatories is prohibited by US
  1010.      Federal Aviation Administration guidelines. Perpetrators are subject to
  1011.      really really big fines and ejection from the plane.
  1012.  
  1013.      Previous incarnations of _a_u_d_i_o_p_a_n_e_l had a DDDDiiiiggggiiiittttaaaallll IIIInnnnppppuuuutttt choice for output
  1014.      ssssaaaammmmpppplllleeee rrrraaaatttteeeessss device by setting its ssssyyyynnnncccc ssssoooouuuurrrrcccceeee to AAAAEEEESSSS IIIInnnn and matching its
  1015.      ssssaaaammmmpppplllleeee rrrraaaatttteeee to the DDDDiiiiggggiiiittttaaaallll IIIInnnn (or AAAAEEEESSSS IIIInnnn ) device on the same audio
  1016.      subsystem.
  1017.  
  1018.      Unlike stand-alone stereo equipment the level mmmmeeeetttteeeerrrrssss have a cost: the
  1019.      mmmmeeeetttteeeerrrrssss consume some CPU and one software audio port per device that
  1020.      otherwise might be useful for some other program.
  1021.  
  1022.      O2 machines with a Presenter flat panel display will have the Presenter
  1023.      audio controls on the Analog Out 2 device.  You may find it necessary to
  1024.      switch the Default Output from the Analog Out device (containing the O2
  1025.      machine speaker) to the Analog Out 2 device (where the Presenter taps its
  1026.      audio) in order to have audio come out the Presenter flat panel speakers.
  1027.  
  1028.      Indy audio hardware input attenuation can't be set to infinite
  1029.      attenuation as on Indigo.
  1030.  
  1031.  
  1032. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1033.      ALintro(3A), audio(3A), rbview(1), X(1), nvram(1M), prom(1M)
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                                                        PPPPaaaaggggeeee 11116666
  1054.  
  1055.  
  1056.  
  1057.